home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / wordproc / hshell1.arj / HS.HYP < prev    next >
Text File  |  1993-12-29  |  63KB  |  1,640 lines

  1. .INDEX
  2. .HEADER
  3.   ~Tg$1~TG - $2 $N ~C55~TC$4  $5~TW
  4. ~a~i6
  5. .FOOTER
  6. ~L21~i0
  7.                     ~APress space bar to continue~PF+~K ~E
  8.  ~j<~L23~i0~X79~b1~Z~h<~L23~i0~X79~b1~X79~Y3~F~Py-~E~X79~Y4~F ~Py-~E~X79~Y21~F ~Py+~E~X79~Y22~F~Py+~E~Z~L23~X2~F-~PF-~K-~E~X$f║~X76~F+~PF+~K+~E
  9. F1 ~AHELP~PkF1~E F2 ~ACONTENTS~PkF2~E F3 ~ABACKSTEP~PkF3~E F4 ~AHISTORY~PkF4~E F5 ~ANOTES~PkF5~E F6 ~ASEARCH~PkF6~E F7 ~ATYPE~PkF7~E F10 ~AQUIT~PkF0~E
  10. .REMARK 
  11. HyperShell hyperfile - Copyright (c) N.G.Taylor 1989,1990,1991
  12. Scrollbar frame design - Copyright (c) Werner Knudsen, 1991
  13. .
  14. .REMARK 
  15. .
  16. .NOTE Scrolling
  17. To scroll between frames or within a frame using keyboard or mouse.
  18.  
  19. Next frame:        Press '+', or click on ~F+~P~E symbol on lower edge.
  20. Previous frame:    Press '-', or click on ~F-~P~E symbol on lower edge.
  21. Position at frame: Move mouse cursor to lower edge and click at the
  22. required position on the bar. The upright shows the current frame.
  23.  
  24.    current frame position          position cursor and click
  25. ════════════════════════║══════════█═══════════════════════════════
  26.  
  27. Next page:     Press 'PgDn', or click on the ~F~P~E symbol on the frame's
  28.                                              ~F ~P~E rightmost edge.
  29.  
  30. Previous page: Press 'PgUp', or click on the ~F ~P~E symbol on the frame's
  31.                                              ~F~P~E rightmost edge.
  32.  
  33. The 'page scroll' symbols only appear when a frame contains more
  34. than 1 page.
  35. .
  36. .REMARK 
  37. Global menus, notes and scripts
  38. .
  39. .MENU Help
  40. Selecting     |NSelecting
  41. Scrolling     |NScrolling
  42. Contents      |NContents
  43. Backtrack     |NBacktrack
  44. Select back   |NSelect back
  45. Noted Frames  |NNoted Frames
  46. Search text   |NSearch text
  47. Type File     |NType File
  48. Do action     |NDo action
  49. DOS Gateway   |NDos Gateway
  50. Quit          |NQuit
  51. Funct. keys   |NFkeys
  52. Other Keys    |NOther Keys
  53. Information   |NInfo
  54. Colour key    |NKey
  55. Noting frames |NINS
  56. Popup menus   |Npopup menu
  57. Paged lists   |NPaged list
  58. .
  59. .NOTE Selecting
  60. Use the  cursor  keys or  the mouse to
  61. move the mouse cursor ('block') to the
  62. reference,  or use  TAB (or SHIFT TAB)
  63. to  move  to  the  next  (or previous)
  64. reference.        Press the LEFT mouse
  65. button or RETURN (ENTER) to select the
  66. reference.
  67.  
  68. Press  RIGHT mouse button or ESCAPE to
  69. select control ~Npopup menu~E.
  70. .
  71. .NOTE Help
  72.             -  F1  -
  73.  
  74. This gives help about using the
  75. HyperShell program.
  76. .
  77. .NOTE Contents
  78.           -  F2  -
  79.  
  80. This provides a ~Npaged list~E
  81. showing the full list of frames
  82. in the hyperfile, and allows
  83. selection of one of them from
  84. the list.
  85. .
  86. .NOTE Backtrack
  87.            -  F3  -
  88.  
  89. This returns to the previous frame
  90. displayed, stepping back one frame
  91. at a time.
  92. .
  93. .NOTE Select back
  94.               -  F4  -
  95.  
  96. This displays a ~Npaged list~E of
  97. frames visited so far, and allows
  98. you to unwind the backtrack list
  99. to the selected frame.
  100. .
  101. .NOTE Noted frames
  102.              -  F5  -
  103.  
  104. This key allows you to  select a
  105. reference previously noted using
  106. the  ~NINS~E  key, from a ~Npaged list~E
  107. of noted references.
  108. .
  109. .NOTE Search Text
  110.                      -  F6  -
  111.  
  112. This selection allows a search to be made for a text
  113. string in the frame texts,  producing a ~Npaged list~E
  114. showing the line of text containing the string and
  115. the  frame within which it was found. You can select
  116. one of the located frames, and you can note the
  117. frames for later viewing using the ~NINS~E key when
  118. the cursor is over their reference. Press any key
  119. during the search to abort at the current point.
  120. .
  121. .NOTE Type file
  122.             -  F7  -
  123.  
  124. This produces a ~Npaged list~E showing
  125. the named file, and permits searching and
  126. bidirectional paging through the file.
  127. .
  128. .NOTE Do Action
  129.              -  F8  -
  130.  
  131. This allows you to enter a HyperShell
  132. action for immediate execution.
  133. Try the action    p=2+3*4
  134. .
  135. .NOTE DOS Gateway
  136.             -  F9  -
  137.  
  138. If you want to  temporarily suspend
  139. viewing the hyperfile, press the F9
  140. key.  When you wish to return, type
  141. 'EXIT' at the DOS prompt.
  142. .
  143. .NOTE Quit
  144.       -  F10  -
  145.  
  146. This exits HyperShell
  147. and returns to DOS.
  148. .
  149. .NOTE INS
  150. Pressing the  INS  key when viewing a
  151. frame  or  when  positioned   over  a
  152. reference  will  add  a  reference to
  153. the  noted  frames  list,  for  later
  154. selection from the ~NNoted frames~E menu.
  155. The  ~NDEL~E  key can be  used  to remove
  156. noted references from the list.
  157. .
  158. .NOTE DEL
  159. The DEL key can be used
  160. to remove  noted frames
  161. from the  notepad list.
  162. Simply position the
  163. cursor for selection
  164. and press the DEL key.
  165. .
  166. .NOTE popup menu
  167. You can select from a  popup menu
  168. by using the cursor keys or mouse
  169. to  highlight  the  option  to be
  170. selected, then press  LEFT  mouse
  171. button or RETURN (ENTER) key.  Or
  172. select using function keys for F1
  173. to F0 or  shifted  function  keys
  174. for S1 to S0.     Press the RIGHT
  175. mouse button or the ESCAPE key or
  176. select outside the menu to cancel.
  177. .
  178. .NOTE Paged list
  179. Paged lists, such as the contents
  180. list,  allow you to page  through
  181. the list using the PgDn, PgUp and
  182. Home keys.       You can select a
  183. frame reference just as you do in
  184. the frame display.  Some function
  185. keys may also be used  in a paged
  186. list  display,  and depend on the
  187. list being viewed.
  188. .
  189. .NOTE Key
  190. A ~Mmenu~PNKey~E gives a menu.
  191. A ~Nnote~PNKey~E displays a note.
  192. A ~Freference~PNKey~E allows a
  193. new frame to be selected.
  194. An ~Aaction~PNKey~E does some
  195. other action.
  196. An ~Iinput field~Pp%s;NKey~E permits some
  197. value to be entered.
  198. .
  199. .NOTE Fkeys
  200. F1 Help        F2  Contents
  201. F3 Backtrack   F4  Select backtrack
  202. F5 Notepad     F6  Search text
  203. F7 Type file   F8  Do action    
  204. F9 DOS Shell   F10 Quit
  205. .
  206. .NOTE Info
  207.    - $9 -
  208.  Frame: $1
  209.  Title: $2
  210.  File : $3
  211.  Date : $4
  212.  Time : $5
  213.  ~ABacktrack ~O2 ~PO2A;NInfo~E with $6 entries
  214.  Error status $? ~C32~AClear~PYah;NInfo~E
  215. .
  216. .SCRIPT envvar
  217. Nenvironment variable
  218. DSET
  219. .
  220. .NOTE environment variable
  221. For details on what environment
  222. variables are, see your MSDOS
  223. manual. Type SET at the DOS
  224. prompt to see the currently
  225. set environment variables.
  226. .
  227. .SCRIPT Onexit
  228. NThanks
  229. Q
  230. .
  231. .NOTE Thanks
  232.     Thank you for trying HyperShell.
  233.  
  234. Why not try the other demonstrations and
  235. then try developing a simple file yourself.
  236. The documentation tells you how to do this.
  237.  
  238. If you find HyperShell of use for developing
  239. your own applications, you must pay a
  240. registration fee to Text Technology for a
  241. licence.
  242.  
  243. See the README file for further details.
  244. .
  245. .SCRIPT position
  246. -- get mouse position
  247. ZG
  248. -- is it on scroll bar
  249. Vg&Y;vg23;anq
  250. Vf&X;vf11;alq
  251. -- if in range, go to frame
  252. Vf=f-10;F&a$f
  253. .
  254. .SCRIPT FTS
  255. -- for frame position indicator
  256. Vf&j$1;Vf=f+10
  257. vf76;alq
  258. Vf76
  259. .
  260. .SCRIPT SETUP
  261. O#
  262. KF1MHelp
  263. KM1HELP
  264. KF0SOnexit
  265. O30
  266. KG1Sposition
  267. KG0SFTS
  268. .
  269. .CHECK of
  270.  
  271. .
  272. .FRAME Welcome
  273. .TITLE to HyperShell
  274. ~i0~Tg
  275.   ╓      ╖                   ╔═════╗
  276.   ║      ║                   ║        ╖            ╖  ╖
  277.   ║      ║                   ║        ║            ║  ║
  278.   ╠══════╣                   ╚═════╗  ║            ║  ║
  279.   ║      ║  ╓    ╖  ╔════╗  ╔════╗  ╔═════     ║  ╠════╗  ╔════╗  ║  ║
  280.   ║      ║  ║    ║  ║    ║  ╠════╝  ║         ║  ║    ║  ╠════╝  ║  ║
  281.   ╙      ╜  ╚════╣  ╠════╝  ╚════╝  ╙       ╚═════╝  ╙    ╜  ╚════╝  ╙  ╙ tm
  282.   ────────────── ║  ║  ──────────────────────────────────────────────────────
  283.             ╚════╝  ╙
  284.  
  285.  
  286.  
  287.  
  288. ~A~Psscroll~E~Q
  289.  
  290.  
  291.   HyperShell is Copyright (c) Text Technology 1988-1993.  All Rights Reserved
  292. .
  293. .SCRIPT scroll
  294. O*31
  295. i~X2~Y14~a~X78~Y19~TR~BG~b3~Ty
  296. LStart
  297. i ~Y1                   --   H Y P E R S H E L L --~C76
  298. i ~w1      HyperShell is a versatile, configurable, hypertext system
  299. Vx&G100;jrnext
  300. i        Which may be used for a number of purposes ~d. . . . . . .
  301. Vx&G100;jrnext
  302. i       Help systems, Reference guides, Menu systems, DOS managers
  303. Vx&G100;jrnext
  304. i ~C76    Information systems, Simple flatfile databases, Text databases
  305. Vx&G100;jrnext
  306. i ~C76  Computer aided instruction, tests, exams with multi choice and timing
  307. Vx&G100;jrnext
  308. i ~C76      Interactive literature, adventure games, prototyping
  309. Vx&G100;jrnext
  310. i ~C76    Slide show presenters, ~DJDemonstration systems~DK, Tutorials
  311. Vx&G100;jrnext
  312. i ~C76   Multi-dimensional outliner for design support and documentation
  313. Vx&G100;jrnext
  314. i ~C76     Catalogues, pricelists, parts guides, diagnostic guides
  315. Vx&G100;jrnext
  316. i ~C76
  317. Vx&G100;jrnext
  318. i ~C76
  319. Vx&G100;jrnext
  320. i ~C76
  321. Vx&G100;jrnext
  322. JStart
  323. Lnext
  324. O*30
  325. Zr
  326. ZU ;
  327. .
  328. .FRAME Directions
  329. .TITLE What do you want to know
  330. This is not one of those demonstrations which lead you through a
  331. complete sequence of fancy displays, without you being able to control
  332. it or 'escape'.  Hypertext is all about you, the user, being in control
  333. of what you want to read, and the order in which you wish to read it.
  334. You can press function key 10 at any time to stop the program.  Well,
  335. what happens now? This depends on how familiar you are with hypertext,
  336. and what you want to find out first.  Press the number key shown next
  337. to one of the options below. Use the F3 key to backtrack to this menu.
  338.  
  339. [1]      ~AWhat is hypertext?~PFHypertext~K1~E
  340. [2]      ~AWhy use hypertext?~PFAdvantages~K2~E
  341. [3]      ~AWhy choose HyperShell?~PFHyperShell~K3~E
  342. [4]      ~AWho is the system for?~PFMarket~K4~E
  343. [5]      ~AWhat can it be used for?~PFUses~K5~E
  344. [6]      ~AWhat do I get for my money?~PFComponents~K6~E
  345. [7]      ~AWhat does Version 5 provide?~PFVersion 5~K7~E
  346. [8]      ~AWhat does it all mean?~PFConcepts~K8~E
  347. [9]      ~AHow do I use the system?~PFNavigation~K9~E
  348. .
  349. .FRAME Hypertext
  350. .TITLE Non linear text
  351.  
  352. Normal 'text', or literature, takes the form of linear  text  in, for
  353. instance, a book.  Hypertext applies the technology provided by modern
  354. computers to the presentation of information in a non-linear fashion.
  355.  
  356. When you are reading a reference book or a tutorial  book, you have
  357. to read all the material, or skip through trying to spot material
  358. of relevance to you.  When you find the information you were looking
  359. for, you often come across concepts or terminology which you have to
  360. look up in a separate chapter or book. To do this you use the contents
  361. list  or  an index, to follow cross references if they are present.
  362.  
  363. With hypertext, the information is shown in manageable chunks, each
  364. covering a few concepts, and each linked to related concepts.  Also
  365. the level of detail shown assumes a knowledgable user, but supports
  366. lower levels of knowledge with additional material as and when
  367. required, rather than assuming the lowest level and providing full
  368. details regardless. Hypertext provides this automatic adaptability
  369. to the user through highlighted words or phrases for which the user
  370. may need further explanation.
  371.  
  372. These cross references can be followed without you worrying about
  373. 'losing your place' due to lack of fingers, pencils and slips of
  374. paper to mark pages on the way to following up a reference. A list
  375. is maintained of the frames of information you have read and you
  376. can step backwards one frame at a time, or directly to one of these.
  377.  
  378. The index of a book is replaced by a powerful search capability
  379. which is quite happy to tell you where every occurrence of 'the'
  380. is in the document.
  381.  
  382. Hypertext may also display pictures for you to look at and on which
  383. to select zones to get more information. It generally provides a
  384. mouse driven interface where you can select the references to
  385. follow by just pointing at them and clicking the mouse button.
  386. .
  387. .FRAME Advantages
  388. .TITLE Why use hypertext
  389.  
  390. Hypertext offers a number of advantages over other methods of
  391. storing and presenting information. Reading a hypertext document
  392. does not require special skills, as the reader just has to select
  393. references as required. This selection can be performed in a
  394. number of intuitive ways.
  395.  
  396. Databases and Freetext Retrieval systems require specialist
  397. knowledge of how to formulate a query.
  398.  
  399. Associations in hypertext are usually 'hard wired' so false
  400. inter-relationships of data do not arise.
  401.  
  402. Of course hypertext, just like conventional literature, may require
  403. that the user knows about the subject matter of the document to a
  404. certain extent. Hypertext does, however, allow the material to be
  405. structured so that an expert is not inundated with superfluous
  406. information, whilst a beginner can obtain all the details needed.
  407. .
  408. .FRAME HyperShell
  409. .TITLE The friendly hypertext system
  410.  
  411. HyperShell is a general purpose ~Fhypertext~E control system,
  412. providing a text frame based presentation style with highlighted
  413. references permitting navigation to other frames in the same or
  414. another file, to graphic screens with selection zones on CGA, EGA,
  415. VGA and Hercules systems, to popup notes which can themselves have
  416. further references, and allowing backtracking through visited
  417. frames, and collection and annotation of references. Also inline
  418. ~Fexpansion references~E in support of the main text are possible.
  419.  
  420. In addition to the more usual hypertext facilities, HyperShell
  421. provides popup menus, menu bar operation, paged displays of menus
  422. or text files, DOS management facilities, scripting language with
  423. programming capability, variables, formfill input fields, program
  424. invocation and support for compressed input files.
  425.  
  426. A comprehensive set of authoring and runtime support programs
  427. are provided to extend the useability and power of this system.
  428. .
  429. .FRAME Hypertext for everyone
  430. .TITLE Advantages of HyperShell
  431.  
  432. HyperShell is  an  attempt  to  make hypertext available at minimal
  433. cost  to  the  general  PC user.  By providing  menu  systems,  DOS
  434. control and a comprehensive set of building  blocks, HyperShell can
  435. be used for many more application areas than previous systems. 
  436.  
  437. HyperShell also provides  an  extension to the Hypertext concept by
  438. removing the requirement  to  always use a specially formatted text
  439. file.   By  loading a HyperShell reference  file  on  a  particular
  440. subject, for instance MSDOS commands,  you  can then browse through
  441. ANY text file containing the odd reference to MSDOS commands.  When
  442. a command is within the  section  of  text displayed on the screen,
  443. that  command  is highlighted as a  frame  reference,  and  can  be
  444. selected  to  display  a frame giving details of that command,  and
  445. permitting full reference selection to take place, before returning
  446. to browsing through the text file.
  447. .
  448. .FRAME Market
  449. .TITLE Who is HyperShell for
  450.  
  451. HyperShell is more than a simple hypertext system and is suitable
  452. for a wide range of general purpose applications. It is therefore
  453. not intended for a specific market and indeed has a very wide
  454. range of users and ~Fuses~E. Most PC users could find a use for it,
  455. either with existing material or for new applications.
  456. The current users of HyperShell include the following:-
  457.  
  458. University and College Lecturers. School teachers. Students.
  459. Management training consultants. Academic administrative and
  460. library staff. Ecclesiastical administration. Accountants.
  461. Hospital administration. Doctors, Pharmacists and Technicians.  
  462. Technical authors.  Mediaware authors.  Anthropologists.
  463. Computer consultants. Computer analysts and programmers.
  464. Shareware distributors.  Electronic engineers.  Architects.
  465. Disaster planning consultants.  Entymologists.  Etymologists.
  466. Museum technicians.  Government Departments.  Coin collectors.
  467. Genealogists.  Ornithologists.  Musicians.  Poets.  Banks.
  468. .
  469. .FRAME Uses
  470. .TITLE What can you use it for
  471. HyperShell can be used for numerous applications including:-
  472.  
  473.  -  Help system with contextual entry and expertise levels
  474.  -  Reference guide with problem diagnostic capabilities
  475.  -  Menuing and help system for control of application programs
  476.  -  Computer aided instruction (CAI) with response analysis
  477.  -  Computer driven tests, exams etc. with multi choice and timing
  478.  -  Text file browser with automatic cross reference to glossary
  479.  -  Object oriented DOS directory browser and manager
  480.  -  Information system, front desk support system
  481.  -  Simple database with formfill, lookup, formatted display
  482.  -  Slide show presenter with mouse selection for further information
  483.  -  Program design specification support / Requirements analysis
  484.  -  Program documentation coupled to source code browser
  485.  -  Free format text database with cross references and associations
  486.  -  Multi-dimensional 'outliner' for designing complex systems
  487.  -  Disk based catalogue/pricelist with easy updating
  488.  -  Interactive literature for participative fiction
  489. .
  490. .FRAME Equipment
  491. .TITLE What you need to run it
  492.  
  493. HyperShell is designed to run on the widest range of equipment,
  494. and the components do not need any more than a minimal 256k
  495. single floppy mono system, although they will benefit from the
  496. use of colour, a mouse, and a hard disk. You need at least a
  497. twin floppy system to develop hyperfiles yourself.
  498.  
  499. Microsoft compatible mice are directly supported. Others
  500. can be used in emulation mode if they are mapped to the
  501. cursor keys, and the buttons to the RETURN and ESCAPE keys
  502.  
  503. HyperShell runs on MSDOS 3.0 and above, Concurrent DOS, OS/2,
  504. DRDOS, and compatible systems such as the Archimedes PC emulator.
  505. It can be run under Desqview if the -d command line flag is used,
  506. and sufficient space is given to allow commands to run alongside
  507. it (180k upwards). It should also run under Microsoft Windows 3.
  508. .
  509. .FRAME HyperShell as a menu
  510. .TITLE More than just a text display
  511.  
  512. As well as providing a basic  Hypertext system, HyperShell provides
  513. the kind of facilities you expect to find in a 'Menu'  system.  You
  514. can have many levels of menu, implemented as frames or popup menus,
  515. and there is a way of having a menu reenter at the  same  point  if
  516. you want HyperShell to leave the whole memory for running a program
  517. You can also include you own help system within a menu  - something
  518. which the other menu systems cannot do. You can also kick off a DOS
  519. 'shell'  to  execute  a  few  commands  from  the command line, and
  520. return to the same position in HyperShell.  It  is also possible to
  521. use password entry before running a program.
  522.  
  523. The hypershell reader program can also swap itself to disk when it
  524. runs another program, occupying just 1500 bytes until it is loaded
  525. again.  This retains the full context allowing the user to continue
  526. where they left off.
  527. .
  528. .FRAME Look and feel
  529. .TITLE Design your own system
  530.  
  531. The fact that HyperShell does not impose  a  fixed screen format on
  532. you is of great benefit to those  using HyperShell as the front-end
  533. to their own  systems.
  534.  
  535. As HyperShell provides input fields, popup menus and  windows,  you
  536. can in fact use  HyperShell  to  'prototype' the  appearance  of  a
  537. system, which can be of benefit to  those  developing  applications
  538. software, as it allows them to try out various layouts  and  styles
  539. before doing the labour intensive work of writing the software.
  540.  
  541. In fact, some users of HyperShell  have  not  bothered with the last
  542. step,  as  they have found the system capable of meeting their needs
  543. as it stands.
  544.  
  545. The next frame shows how you can utilise another program's appearance.
  546. .
  547. .FRAME Captured screen
  548. .TITLE )Example of captured text
  549. ~TK~BW   ~TRF~TKile   ~TRE~TKdit   ~TRR~TKun   ~TRC~TKompile   ~TRP~TKroject   ~Tw~BKOptions~TK~BW   ~TRD~TKebug   ~TRB~TKreak/watch        
  550. ~TW~BB╒════════════════════════════════════~Tw Edit~TK~BW┌──────────────────┐~TW~BB═════════════════╕
  551. │      Line 1     Col 1   Insert Indent Ta~TK~BW│~Tw~BK Compiler         ~TK~BW│~TW~BBHELLO.C          │
  552. │~Ty/*      HELLO.C -- Hello, world */       ~TK~BW│ ┌───────────────────────────┐~Ty~BB      ~TW│
  553. │~Ty                                         ~TK~BW│ │ ~TRM~TKodel            Small    │~Ty~BB      ~TW│
  554. │~Ty#include <stdio.h>                       ~TK~BW│ │ ~TRD~TKefines                   │~Ty~BB      ~TW│
  555. │~Ty                                         ~TK~BW│ │~Tw~BK Code generation           ~TK~BW│~Ty~BB      ~TW│
  556. │~Tymain()                                ~TK~BW┌──────────────────────────────────────┐~TW~BB│
  557. │~Ty{                                     ~TK~BW│ ~TRC~TKalling convention       C           │~TW~BB│
  558. │~Ty        printf("Hello, world\n");     ~TK~BW│ ~TRI~TKnstruction set          8088/8086   │~TW~BB│
  559. │~Ty}                                     ~TK~BW│ ~TRF~TKloating point           Emulation   │~TW~BB│
  560. │~Ty                                      ~TK~BW│ ~TRD~TKefault char type        Signed      │~TW~BB│
  561. │~Ty~A~PnExample~E~Q                                      ~TK~BW│ ~TRA~TKlignment                Byte        │~TW~BB│
  562. │~Ty~A~PF+~K ~E                                      ~TK~BW│ ~TRG~TKenerate underbars       On          │~TW~BB│
  563. │~Ty                                      ~TK~BW│~Tw~BK Merge duplicate strings  On          ~TK~BW│~TW~BB│
  564. │~Ty                                      ~TK~BW│ ~TRS~TKtandard stack frame     On          │~TW~BB│
  565. │~Ty                                      ~TK~BW│ ~TRT~TKest stack overflow      Off         │~TW~BB│
  566. │~Ty                                      ~TK~BW│ ~TRL~TKine numbers             Off         │~TW~BB│
  567. │~Ty                                      ~TK~BW│ ~TRO~TKBJ debug information    On          │~TW~BB│
  568. │~Ty                                      ~TK~BW└──────────────────────────────────────┘~TW~BB│
  569. │~Ty                                                                              ~TW│
  570. ├────────────────────────────────── Message ───────────────────────────────────┤
  571. │~Tw   Press space to continue                                                    ~TW│
  572. └──────────────────────────────────────────────────────────────────────────────┘
  573. ~TK~BW ~TRF1~TK-Help  ~TRF5~TK-Zoom  ~TRF6~TK-Switch  ~TRF7~TK-Trace  ~TRF8~TK-Step  ~TRF9~TK-Make  ~TRF10~TK-Quit  ~Tw~BB NUM ~TK~BW    
  574. .
  575. .NOTE Example
  576. This is an example of a text
  577. screen captured with HCAP and
  578. then converted to a frame using
  579. the HI edit mode. It shows that
  580. you can easily capture the
  581. presentation style of other
  582. programs. Press the space bar
  583. to continue.
  584. .
  585. .FRAME The hyperfile
  586. .TITLE HyperShell media files
  587.  
  588. HyperShell  reference  files (known as hyperfiles) have a  notation
  589. which can  be  readily  understood,  whilst  providing  a degree of
  590. conciseness in  the  more  powerful areas that is far preferable to
  591. the excessive verbosity of  some of the scripting languages used by
  592. other hypertext systems.  Extensive  parsing  has  been avoided for
  593. performance and space reasons,  and  because it does not provide as
  594. much  as it costs.
  595.  
  596. HyperShell provides a script language preprocessor so that verbose
  597. specifications can be translated to the standard HyperShell syntax.
  598. This allows a full language style to be used, without affecting the
  599. speed or size of the HyperShell reader program, and also allows the
  600. compact runtime hyperfile structure to be maintained.
  601. .
  602. .FRAME Hyperbooks
  603. .TITLE A new publishing method
  604.  
  605. Using a special compression format, it is possible for authors to
  606. write hyperfiles up to around 5 or 6 hundred frames, which can be
  607. compressed and fitted onto a 360k floppy disk along with the
  608. HyperShell reader program.
  609.  
  610. It is thus possible to publish your own material. This form of
  611. publishing is a very cheap way of producing high quality material
  612. which also benefits from the hypertext capabilities. Catalogues
  613. and price lists can be easily kept up to date in this form.
  614.  
  615. Reference material is an ideal application for hypertext. A well
  616. designed reference text can lead the reader to the information
  617. they require very quickly.
  618.  
  619. Interactive literature is another application for hypertext, and
  620. can take the form of 'adventure' systems or other kinds of fiction.
  621. .
  622. .FRAME Design aims
  623. .TITLE What it should provide
  624.  
  625. HyperShell has been designed with the following goals in mind:-
  626.  
  627. * Fast startup and high performance navigation.
  628.  
  629. * File size not limited by available memory.
  630.  
  631. * Minimal  memory  usage when used as a menuing system. 
  632.  
  633. * Text format material for ease of production and maintenance.
  634.  
  635. * Full hypertext functionality extended to support real applications.
  636.  
  637. * Extensive configurability for presentation style and interaction.
  638.  
  639. * Incremental learning - no steep 'first step' to producing material.
  640.  
  641. * Comprehensive set of authoring and support programs.
  642. .
  643. .FRAME Components
  644. .TITLE What you get with HyperShell
  645. Components provided include the following-
  646.  
  647. 1.  Various versions of the text mode HyperShell reader
  648. 2.  The graphic version of the HyperShell reader
  649. 3.  Integrated Development Environment, plus a graphic version
  650. 4.  Extensive preprocessor and syntax checking program
  651. 5.  Formatted hyperfile printout utility with glossary and index
  652. 6.  General text editor, and a special note file editor
  653. 7.  Conversion program for Norton Guide(tm) format files
  654. 8.  Resident PCX or BLOAD graphic and text screen capture programs
  655. 9.  Graphic preparation facilities for clips and full screen images
  656. 10. Graphics conversion, Paint program, Resource editor
  657. 11. Compression and expansion components and librarian
  658. 12. Resident popup subset of HyperShell for help applications
  659. 13. Resident floating point calculator and unit convertor 
  660. 14. Example hyperfiles
  661. 15. Additional preparation programs and runtime support programs
  662. .
  663. .FRAME Documentation
  664. .TITLE documentation files provided
  665. Resources provided include:-
  666.  
  667. 1. A number of icons in ICO format
  668. 2. A small selection of clip art and images in PCX format
  669. 3. over 50 fonts of assorted sizes in UDG format
  670. 4. Some simple sounds in HSN format
  671. 5. A number of mouse pointers in HMC format
  672. 6. Some palette files in PAL format
  673.  
  674. Documentation includes:-
  675.  
  676. 1. Extensive users (authors) guide to HyperShell specification.
  677. 2. A utilities guide to the range of programs provided with HyperShell.
  678. 3. A hypertext document containing a full reference guide.
  679. 4. A Quick reference guide on disk and in printed format.
  680. .
  681. .FRAME Integrated Environment
  682. .TITLE The interactive development environment
  683.  
  684. HyperShell includes a configurable editing environment, which can be
  685. used for creating and maintaining hyperfiles.  It can also be set up
  686. for use as a free text storage database and other similar applications.
  687.  
  688. The integrated environment offers the full reader functionality,
  689. so you can browse around a hyperfile and edit it immediately, with
  690. the option of 'backing out' changes you have made.
  691.  
  692. Optional 'in-memory' editing makes editing easy and fast, whilst the
  693. capability of working 'from disk' for larger hyperfiles is retained.
  694. .
  695. .FRAME Hyperfile checker
  696. .TITLE Syntax and referential integrity checks
  697.  
  698. The Hyperfile checker provides a preprocessor for translating
  699. the verbose HSL (HyperShell source language) into standard
  700. HyperShell runtime specification language. 
  701.  
  702. The HyperShell Checker program also performs a number of
  703. checks against a hyperfile. It does checks for cross
  704. references, duplicates, action codes in action references,
  705. scripts and menus, dynamic menu codes, formatting codes,
  706. sizing checks and section ordering. It can also provide:-
  707.  
  708. 1. Summary totals of frames, items, and errors.
  709. 2. Cross-reference file showing inter-relationships.
  710. 3. Automatically generated frames and items to match references
  711. 4. Embedded error messages for use in the editor
  712. .
  713. .FRAME Hyperfile printer
  714. .TITLE HyperShell formatted print utility
  715. The HyperShell Printer program allows your hypertext documents
  716. to be formatted and printed. This component provides:-
  717.  
  718. 1. A listing of the text with optional highlighting using either
  719.    the built-in Epson(tm) or IBM(tm) compatible escape sequences,
  720.    Hewlett Packard LaserJet/DeskJet escape sequences,
  721.    or escape sequences set up using the configuration file.
  722. 2. Optional page breaks and index.
  723. 3. Optional full list showing all items, or notes as glossary.
  724. 4. Serial numbering of frames and items
  725. 5. Optional detailed list of references used in each item.
  726. 6. Support of special .PRINT directives allowing full control
  727.    of printing, headings, page throws, section numbering, etc.
  728. 7. Single frame print for use from reader component.
  729. 8. Optional output in Word Processor form (no line breaks).
  730. .
  731. .FRAME Note editor
  732. .TITLE For editing small text files
  733. The note editor provides a convenient means of editing small
  734. text files (less than 400 lines), for use as notes, menus or
  735. scripts.
  736.  
  737. It can also be used in support of a hyperfile as a means of
  738. creating adhoc annotation text files related to a frame.
  739.  
  740. The editor has an easy set of editing commands, using either
  741. control keys or a popup menu bar for entering the commands.
  742. It also has a popup help screen showing the key mappings.
  743.  
  744. It provides block editing operations, word wrap and paragraph
  745. formatting, which can be performed automatically.
  746.  
  747. The editor screen position, colours and style are set up
  748. using the command line parameters, so it can be blended with
  749. the frame display.
  750. .
  751. .FRAME Graphics capture
  752. .TITLE Graphics capture and preparation
  753.  
  754. The screen capture and preparation system provides the tools
  755. necessary to capture text and graphic screens from other
  756. program displays, and prepare them for use within HyperShell.
  757. The components provided are:-
  758.  
  759. 1.  TSR (Resident) screen capture program for text screens and CGA
  760.     and EGA graphic screens.
  761.  
  762. 2.  Preparation facility to allow selection zones to be defined
  763.     interactively, and actions mapped to the selections in a menu
  764.     for inclusion in a hyperfile.
  765.  
  766. Graphic screens can be compressed using the ~FFile compression~E
  767. component, and substantial reductions in size are possible.
  768.  
  769. See Also the HyperShell Version 5 ~FGraphics preparation~E tools
  770. .
  771. .FRAME File compression
  772. .TITLE For reducing the size of files
  773.  
  774. The HyperShell reader program, the integrated environment, the print
  775. program and the checking program can determine if any input file is
  776. compressed and handle the file access accordingly.
  777.  
  778. The compressed file maintenance program handles the compression and
  779. expansion of text files, including hyperfiles, and screen image files:-
  780.  
  781. 1. When compressing a file it can optionally change the
  782.    compression so that the file cannot be accessed as other
  783.    than a main hyperfile - to stop it being changed or used for
  784.    other purposes.
  785.  
  786. 2. It can expand a file to its previous form, or display it
  787.    on the screen a page at a time.
  788. .
  789. .FRAME Popup subset
  790. .TITLE For help systems
  791.  
  792. The resident popup HyperShell subset, known as HyPop, provides
  793. a context sensitive popup help system, which can be used for
  794. a wide range of applications.
  795.  
  796. It is available at the touch of a Hot Key. It takes the word
  797. you currently have the text cursor positioned over as a search
  798. string, and tries to find a frame about this word. Otherwise
  799. it displays the index frame for you to navigate to the frame.
  800.  
  801. This program can be used for a wide range of help system
  802. applications. The file format is a subset of HyperShell, and
  803. so the files may be prepared using the integrated environment
  804. and may be viewed using the standard HyperShell reader. The
  805. files used by HyPop can be in compressed format.
  806.  
  807. The memory used by the program, and the 'HotKey' used to
  808. call it up, may be specified in the file.
  809. .
  810. .FRAME Floating Point
  811. .TITLE For mathematicians and engineers
  812.  
  813. The HyperShell Resident Extension, or HRX for short, is a means of
  814. adding optional blocks of functionality to the basic HyperShell
  815. programs, without compromising size or speed. The HRX is loaded into
  816. the computers memory before running HyperShell.
  817.  
  818. The first one of these is supplied with version 4, and this
  819. provides full floating point maths and unit and base conversions.
  820. It also provides a set of variables for storage of intermediate
  821. results. 
  822.  
  823. This resident extension has a very fast 'seamless' interface
  824. which makes it appear as though the facilities are built
  825. into HyperShell.
  826. .
  827. .FRAME Version 5
  828. .TITLE HyperShell Illustrated Edition
  829. The graphic version of HyperShell brings a wealth of new material
  830. to allow the production of a multitude of HyperMedia applications.
  831.  
  832. [1]    ~FGraphic HyperShell~K1~E    The graphic version of HyperShell
  833.  
  834. [2]    ~FPaint Program~K2~E         For the preparation of images
  835.  
  836. [3]    ~FGraphics preparation~K3~E  For capture and conversion of images
  837.  
  838. [4]    ~FResource editor~K4~E       For creation and editing of small bitmaps
  839.                              Icons, Mouse cursors, Fonts, Patterns
  840.  
  841. [5]    ~FPreparation support~K5~E   Textual material preparation
  842.  
  843. [6]    ~FRuntime support~K6~E       Additional runtime programs
  844.  
  845. .
  846. .FRAME Graphic HyperShell
  847. .TITLE HyperShell with graphics
  848. HyperShell Illustrated Edition is a graphic version of HyperShell
  849. which supports full colour text in multiple fonts mixed with
  850. graphics clips and graphic trim. Custom mouse cursors and palettes
  851. are also supported. This is provided through the following:-
  852.  
  853. - Graphic clip sublanguage providing raster image clip display in
  854.   frames and notes, with image reference selection support. Also
  855.   adhoc clip capture, inversion and display. Supports library file
  856.   and high compression images for minimum memory usage. Mouse
  857.   cursor and palette loading.
  858.  
  859. - Graphics draw sublanguage providing pixel, pixel sequence and
  860.   line drawing with XOR capability for add/remove processing.
  861.  
  862. - Modes supported:- CGA mono (640x200), EGA colour (640x200)
  863.   EGA hires colour (640x350) and VGA hires colour (640x480).
  864.   There is also some partial VGA 256 colour and Hercules support.
  865. .
  866. .FRAME Paint Program
  867. .TITLE HyperShell paint program
  868. The paint program is a full featured paint package, providing a range
  869. of standard painting tools as well as some specialist processing tools
  870. for the production of graphic clips to be use in Graphics HyperShell.
  871.  
  872. - Freehand and straight line drawing, plus random and radial spray.
  873. - Outline and filled boxes and ellipses, with special shadow effects.
  874. - 11 scaleable Fonts with vertical or horizontal display. Text import.
  875. - 36 fill patterns including 26 user definable patterns.
  876. - Region processing commands including skew, invert, move, mirror,
  877.   convert colours, half colours, gradient fills, reduce, magnify
  878. - Load full screen or clip from .PCX and Windows .BMP images
  879. - Load graphic clips in .HGP, .BGF and .TIC formats
  880. - Save clips in .HGP, .BGF, .TIC formats. Save full screen .PCX images
  881. - Load, edit and save palettes in .PAL format
  882. - Print to Laserjet (Dot Matrix not yet supported)
  883.  
  884. See the DEMO of version 5 for an illustrated tour of HPAINT.
  885. .
  886. .FRAME Graphics preparation
  887. .TITLE Conversion of other graphic formats
  888. Graphic capture - The HCAPPCX program is a TSR resident program which
  889.                   may be used to capture .PCX images in the following
  890.                   modes:- 640x200, 640x350, 640x480 (and 640x480mono)
  891.  
  892. Graphic convert - Conversion of GIF formats to PCX, for display in HG
  893.                   and for use with the paint package. Can convert 256
  894.                   colour images to 16 colours for use with HG.
  895.  
  896. Compression     - A compression system offering a high ratio of
  897.                   compression, for use with the graphic HyperShell
  898.                   program.
  899.  
  900. Librarian       - A program used for storing images and other
  901.                   resources in a single library file, for use in the
  902.                   graphics HyperShell program. 
  903. .
  904. .FRAME Resource editor
  905. .TITLE For the preparation of icons, fonts etc
  906. The resource editor is a small bitmap editor permitting the
  907. preparation of icons, mouse cursors and fonts for use in HG.
  908. General editing commands include line and box drawing, cell
  909. shifting and colour conversions.
  910.  
  911. Icons         - Various sizes up to 40 by 32 pixels
  912.               - Load in .BGF, .TIC, .HGP, Windows .ICO
  913.               - Save in .HGP or .TIC format
  914.               - Can produce BGI .C structure for use in programs
  915. Mouse cursors - Edit cursor and screen mask
  916.               - Load in .HMC format
  917.               - Save in .HMC format
  918.               - Can produce .C structure for use in programs
  919.               - Can test mouse cursor during editing
  920. Fonts         - Supports any depth by 8 bits wide
  921.               - Loads .UDG and many other font formats
  922.               - Saves .UDG for use in HG
  923.               - Powerful global processing commands
  924. .
  925. .FRAME Preparation support
  926. .TITLE For the preparation of hyperfiles
  927. The text file preparation utilities include the following.
  928.  
  929. Preparation program - This is for use in the initial stages of text
  930.      preparation to clean up and format text for use as a hyperfile.
  931.      It also provides statistics for a file, encrypts files etc etc. 
  932.  
  933. Difference - This allows you to locate differences between versions
  934.      of textual material, optionally producing a changebar.
  935.  
  936. Spell checker - This checks the textual content of a hyperfile, and
  937.      can produce an errors file for use within the integrated
  938.      environment. It can also be used to extract pure text from a
  939.      hyperfile.
  940.  
  941. General Text Editor - This is for the preparation and maintenance
  942.      of text files. It can be used for hyperfiles up to 500k and
  943.      for configuration and other miscellaneous files.
  944. .
  945. .FRAME Runtime support
  946. .TITLE Additional runtime components
  947. HFIND - A background program for use with HyperShell. This can
  948.         find files on your hard disk, and can find text strings
  949.         in specified files. It can output in HyperShell paged
  950.         selection format, and also in HTYPE selection format.
  951.  
  952. HTYPE - A simple program to browse text files, with mouse control.
  953.         Lets you browse your directory structure and view files.
  954.         Supports simple hypertext links within files and across
  955.         files.
  956.  
  957. HFONT - A program to load .UDG fonts for use in text mode on
  958.         EGA and VGA adaptors. A number of fonts are provided.
  959. .
  960. .FRAME Resident Shell for HyperShell
  961. .TITLE to popup HyperShell and its variants
  962.  
  963. HSRES is a resident shell occupying just 7k which permits HyperShell
  964. to be popped up when you are in any non-graphic application.
  965.  
  966. It may be configured to pop up any of the versions of HyperShell,
  967. and to pass certain information on the command line, it can utilise
  968. hard disk or extra memory for swapping, and is now bundled in with
  969. the HyperShell licence fee.
  970.  
  971. Also available is PGRES, which is a general resident shell for use
  972. with certain programs other than HyperShell, allowing these to be
  973. popped up when you are in any non-graphic application. This is
  974. available at extra cost.
  975. .
  976. .FRAME HyperDex
  977. .TITLE )Database extension
  978.        ~Tr░░     ░░~TW ~Tb                                ~TW ~Tr░░░░░░░~TW ~Tr                 ~TW     
  979. A      ~Ty░░     ░░~TW ~Tw                                ~TW ~Ty░░  ~TW  ~Ty░░                 ~TW     
  980.        ~Tg░░     ░░~TW ~Tb                                ~TW ~Tg░░  ~TW  ~Tg░░                 ~TW     
  981. N      ~Tb░░     ░░~TW ~Tw                                ~TW ~Tb░░ ~TW   ~Tb░░                 ~TW     
  982.        ~Tm░░░░░░░░░~TW  ~Tm░░~TW   ~Tm░░~TW  ~Tm░░░░░░  ░░░░░~TW ~Tm ░░░░░░~TW  ~Tm░░ ~TW   ~Tm░░~TW  ~Tm░░░░░~TW  ~Tm░░~TW   ~Tm░░~TW      
  983. N      ~TC░░░░░░░░░~TW  ~TC░░~TW   ~TC░░~TW  ~TC░░~TW  ~TC░░  ░  ~TW ~TC░~TW ~TC ░░~TW      ~TC░░ ~TW   ~TC░░~TW  ~TC░~TW   ~TC░~TW   ~TC░░~TW ~TC░░~TW       
  984.        ~TR░░~TW     ~TR░░~TW  ~TR░░~TW   ~TR░░~TW  ~TR░░~TW  ~TR░░  ░   ░~TW ~TR ░░~TW      ~TR░░~TW    ~TR░░~TW  ~TR░~TW   ~TR░~TW    ~TR░░░~TW        
  985. O      ~TG░░~TW     ~TG░░~TW  ~TG░░~TW   ~TG░░~TW  ~TG░░~TW  ~TG░░  ░░░░░~TW  ~TG░░~TW      ~TG░░~TW    ~TG░░~TW  ~TG░░░░░~TW    ~TG ░ ~TW        
  986.        ~TB░░~TW     ~TB░░~TW  ~TB░░~TW   ~TB░░~TW  ~TB░░~TW  ~TB░░  ░      ░░      ░░~TW    ~TB░░~TW  ~TB░~TW       ~TB░░~TW ~TB░░~TW       
  987. U      ~TY░░~TW     ~TY░░~TW  ~TY░░░░░░░~TW  ~TY░░░░░░  ░░░░░~TW  ~TY░░~TW      ~TY░░░░░░░~TW   ~TY░░░░░~TW  ~TY░░~TW   ~TY░░~TW      
  988.        ~Tw┌────────┐~TW      ~Tc░░~TW  ~Tc░░~TW ~Tw┌──────────────────────────────────────────┐~TW      
  989. N      ~Tw│  Full  │~TW      ~TC░░~TW  ~TC░░~TW ~Tw│  ~TrHyperShell Database Extension option~Tw    │~TW      
  990.        ~Tw│Database│~TW ~Tb░░~TW   ~Tb░░~TW  ~Tb░░~TW ~Tw│    ~TgA fully fledged database system ~Tw      │~TW      
  991. C      ~Tw└────────┘~TW ~Tg░░░░░░░~TW  ~Tg░░~TW ~Tw└──────────────────────────────────────────┘~TW      
  992.      ~Tw    ┌─────────────────────────────────────────────────────────────────┐~TW    
  993. I      ~Tw┌─┴───────────────────────────────────────────────────────────────┐~TW ~Tw│~TW    
  994.        ~Tw│~TK ~BW HyperDex is an extended version of HyperShell, supporting the ~Tw~BK │~TW ~Tw│~TW    
  995. N      ~Tw│ ~TK~BW database, index and memo file formats of dBase III and IV.    ~Tw~BK │~TW ~Tw│~TW    
  996.        ~Tw│ ~TK~BW HyperDex is available for an additional 30 pounds personal    ~Tw~BK │~TW ~Tw│~TW    
  997. G      ~Tw│ ~TK~BW licence and an additional 90 pounds developer licence.  With  ~Tw~BK │~TW ~Tw│~TW    
  998.        ~Tw│ ~TK~BW Version 5, you can store graphics and sounds in the database. ~Tw~BK ├─┘ ~TW   
  999.        ~Tw└─────────────────────────────────────────────────────────────────┘   ~TW
  1000.                     ~APress spacebar to continue~PF+~K ~E
  1001. .
  1002. .FRAME Concepts
  1003. .TITLE Features and capabilities of HyperShell
  1004.  
  1005.              H Y P E R S H E L L   C O N C E P T S
  1006.  
  1007. The terminology used in hypertext has not given us many standard
  1008. terms yet.  HyperShell introduces a number of innovative ideas
  1009. for which terminology has had to be created.
  1010.  
  1011. This section gives an introduction to the terms and concepts used
  1012. in HyperShell, and describes how these are used. 
  1013.  
  1014.  ~FHyperfile~E   ~FReferences~E  ~FExpansion references~E   ~FPaged displays~E
  1015.  
  1016.  ~FFrame~E       ~FNote~E        ~FMenu~E      ~FScript~E       ~FActions~E
  1017.  
  1018.  ~FNavigation~E  ~FBacktrack~E   ~FControl menu~E           ~FNotepad~E
  1019.  
  1020. Select one of these, or press the spacebar to work through them.
  1021. Press F3 to return here afterwards.
  1022. .
  1023. .FRAME hyperfile
  1024. .TITLE HyperShell control file
  1025.  
  1026. HyperShell uses data (or 'media') files called ~Fhyperfile~Es.
  1027.  
  1028. A hyperfile is a simple text file, and can be edited with a
  1029. word processor or a text editor, and viewed using text file
  1030. viewing programs, such as TYPE.
  1031.  
  1032. The process of creating a hyperfile is known as 'authoring'.
  1033. As a hyperfile is the equivalent of a book, the creator of
  1034. a hyperfile is its 'author'.
  1035.  
  1036. The material produced is subject to copyright laws, and usually
  1037. has a copyright statement indicating the author and date.
  1038. .
  1039. .FRAME frame
  1040. .TITLE unit of display
  1041.  
  1042. A frame is a unit of textual information containing references,
  1043. which is displayed during the normal operation of HyperShell.
  1044. What you are reading now is a frame called 'frame'.
  1045.  
  1046. Frames generally fit on one screen, but it is possible that
  1047. they could be split onto two or more screensfull, in which
  1048. case you can use the PgDn, PgUp and Home keys to move around
  1049. them.
  1050.  
  1051. A list of frames in a ~Fhyperfile~E is given in a ~Fcontents~E listing.
  1052. .
  1053. .FRAME Mouse
  1054. .TITLE Using a mouse
  1055.  
  1056. If you have a mouse compatible with HyperShell installed on
  1057. your system, with a mouse driver installed, HyperShell will
  1058. use the mouse driver directly. If you don't want to use the
  1059. mouse driver, specify the -m command line switch when running
  1060. HyperShell:-
  1061.  
  1062.     hs -m hs
  1063.  
  1064. The block cursor should respond when you push your mouse about.
  1065. If it is not compatible, or if you do not have the driver
  1066. installed, it will have no effect. In this case, see the ~Fkeyboard~E
  1067. instructions for details of keyboard control of HyperShell.
  1068. .
  1069. .FRAME left
  1070. .TITLE left mouse button
  1071.  
  1072. The left mouse button, and the RETURN key, both have the
  1073. same action. This is generally to select an item over
  1074. which the ~Fmouse~E cursor is positioned.
  1075.  
  1076. When viewing a text file, requested by the ~FTYPE FILE~E
  1077. option from the ~Fcontrol menu~E, this selection returns to
  1078. the frame display, on a temporary basis.
  1079. .
  1080. .FRAME right
  1081. .TITLE right mouse button
  1082.  
  1083. The right ~Fmouse~E button has two main uses:-
  1084.  
  1085. To request the ~Fcontrol menu~E to control HyperShell,
  1086. when viewing a text frame. This facility is not
  1087. available at other times.
  1088.  
  1089. To cancel an operation which is in progress and
  1090. awaiting some input.
  1091. .
  1092. .FRAME middle
  1093. .TITLE the Insert button
  1094.  
  1095. If you have a 3 button mouse like the Genius mouse, the
  1096. middle key might be able to be used as an INSert key.
  1097.  
  1098. This can be used for:-
  1099.  
  1100. [1]    ~NSelecting references~PNINS~K1~E - for the notepad
  1101.  
  1102. [2]    ~FPicking words~PFText input~K2~E - on text input
  1103. .
  1104. .FRAME Keyboard
  1105. .TITLE Using the keyboard
  1106.  
  1107. The keyboard may be used in ~FHyperShell~E in a number of ways.
  1108.  
  1109. The ~Fcursor keys~E and others can be used when viewing ~Fpaged displays~E.
  1110.  
  1111. The ~FFunction keys~E can generally be used for control functions,
  1112. and the unshifted function keys are mapped to the actions provided
  1113. on the ~Fcontrol menu~E.
  1114.  
  1115. The RETURN and ESCAPE key have the same purpose as the ~Fleft~E
  1116. and the ~Fright~E mouse buttons.
  1117.  
  1118. The remaining keys can be mapped for control purposes or
  1119. selection of ~Freferences~E.
  1120.  
  1121. Also see ~FText Input~E for details of entering strings.
  1122. .
  1123. .FRAME Function Keys
  1124. .TITLE Direct control actions
  1125.  
  1126. The function keys, when used without the shift keys,
  1127. are mapped to the control menu actions. Pressing ESCAPE,
  1128. or the right mouse button, will bring up the ~Fcontrol menu~E
  1129. to show the available control actions.
  1130.  
  1131. Certain ~Fhyperfile~Es may map the ESCape key and right mouse
  1132. button to another form of control, such as a menubar, or
  1133. disable them altogether. 
  1134. .
  1135. .FRAME Cursor Keys
  1136. .TITLE Selection cursor movement
  1137.  
  1138. The cursor keys are used to move the mouse cursor, which
  1139. may be positioned to enable selection for a ~Freference~PFreferences~E, or
  1140. a choice on a ~Fmenu~E.
  1141.  
  1142. .
  1143. .FRAME Text input
  1144. .TITLE String input and the copy cursor
  1145.  
  1146. When input is requested on the bottom line of the display and
  1147. when an input field is being used, the keyboard is used as usual
  1148. for inputting text. The RETURN key should be pressed to terminate
  1149. input, and the cursor keys may be used to position the cursor
  1150. within the text string to insert or delete characters.
  1151.  
  1152. It is also possible to copy a word or number from the screen when
  1153. in this mode by first pressing the PgUp key. Then by positioning
  1154. the mouse cursor over the word to be copied, pressing the INSERT
  1155. key will insert the word into the text. Also any text can be copied a
  1156. character at a time using the HOME key. This will copy a character
  1157. and move the cursor along one position, so the key can be held down
  1158. to auto-repeat when copying a string, or alternating INSERTs and
  1159. HOMEs can be used to copy a sequence of words. This mode can be
  1160. exited by pressing the PgDn or any normal key.
  1161. .
  1162. .FRAME Paged displays
  1163. .TITLE multi page selection lists
  1164.  
  1165. Paged displays are used to display various lists that may
  1166. occupy more than one screenful. Certain keys are available
  1167. during a paged display.
  1168.  
  1169. The PgDn and the HOME keys are always available, and allow
  1170. you to page through the list or return to the start.
  1171.  
  1172. The PgUp and END keys may also be available, and allow you
  1173. to move backwards through the list, or move to the end.
  1174. .
  1175. .FRAME Navigation
  1176. .TITLE How to browse a HyperShell document
  1177.  
  1178. This section describes how to use ~FHyperShell~E.
  1179. ~A~PZX74;ZY6~E~Q
  1180. If you have a mouse, you can use it to move the mouse cursor  ->
  1181. around the screen to certain highlighted words or phrases called
  1182. references, and press the left button to select the reference.
  1183. Select ~FMouse~E for a full description of mouse usage.
  1184.  
  1185. If you don't have a mouse, you can always use the keyboard.
  1186. The cursor keys move the mouse cursor around. Press Tab
  1187. for the next highlit field and Shift/Tab for the previous one.
  1188. Press the RETURN key to select a field, or ESCAPE to cancel.
  1189. Select ~FKeyboard~E for a full description of keyboard usage.
  1190.  
  1191. If you want to exit to DOS at any point, just press F10.
  1192. .
  1193. .REMARK 
  1194. Features of HyperShell
  1195. .
  1196. .FRAME References
  1197. .TITLE Types of reference in text
  1198. ~i2
  1199. [f]   A ~FFrame~PnFrame~Kf~E reference allows you to move to a new frame
  1200.  
  1201. [n]   A ~nNote~Kn~E reference pops up a small textual note for you
  1202.  
  1203. [m]   A ~MMenu~PnMenu~Km~E reference pops up a menu for you to choose from
  1204.  
  1205. [s]   A ~SScript~PnScript~Ks~E reference does a sequence of actions
  1206.  
  1207. [a]   An ~AAction~PnAction~Ka~E does an unspecified action of some sort
  1208. ~i6
  1209. The above references in this frame all pop up notes describing
  1210. their normal function. Press the key in [brackets] to select one.
  1211. As you can see, keys can also be mapped to references.
  1212. ~i2
  1213. [e]  An ~AExpansion Reference~PZL1~Ke~E provides additional information 'inline'.
  1214. ~h1     ~FExpansion references~E provide additional material which becomes
  1215. ~h1     visible when they are selected, and may be removed by reselecting.
  1216. .
  1217. .NOTE Frame
  1218.  
  1219.   A frame reference allows you to
  1220.   move to another frame of text.
  1221.   To get back from that frame, you
  1222.   can use the backtrack facility.
  1223.  
  1224.  
  1225.   ~FMore on Frame references~PFFrame Reference~E
  1226.  
  1227. .
  1228. .NOTE Note
  1229.  
  1230.   A note pops up a small window
  1231.   containing some information
  1232.   about the word highlighted.
  1233.   You are reading a note now.
  1234.  
  1235.   ~FMore on Notes~PFNote~E
  1236.  
  1237. .
  1238. .NOTE Menu
  1239.  
  1240.   A menu pops up a list of items
  1241.   for you to select from. You can
  1242.   cancel the selection by clicking
  1243.   the mouse outside the menu or
  1244.   by pressing the right mouse button
  1245.  
  1246.   ~FMore on Menus~PFMenu~E
  1247.  
  1248. .
  1249. .NOTE Script
  1250.  
  1251.   A script performs a sequence of
  1252.   actions. This may do something like
  1253.   displaying a series of notes, or
  1254.   prompting for a number of parameters
  1255.   for a command to be issued to DOS.
  1256.  
  1257.   ~FMore on Scripts~PFScript~E
  1258.  
  1259. .
  1260. .NOTE Action
  1261.  
  1262.   An action is almost anything,
  1263.   including Notes, Menus,
  1264.   Backtracking, Prompting, issuing
  1265.   DOS commands or even Quitting.
  1266.  
  1267.   ~FMore on Actions~PFAction Reference~E
  1268.  
  1269. .
  1270. .FRAME Frame reference
  1271. .TITLE go to a frame
  1272.  
  1273. When a frame reference is selected, the ~Fframe~E selected is
  1274. displayed on the screen, replacing the one currently on display.
  1275. Frames, or other references may be selected from this frame to
  1276. further follow up the reference.
  1277.  
  1278. When the necessary information has been found, it is possible
  1279. to ~Fbacktrack~E to any of the previous frames you have seen, either
  1280. one step at a time or by selecting from the ~Alist of frames~PFbacktrack list~E you
  1281. have seen.
  1282.  
  1283. Certain frame reference selections do not get added to
  1284. the ~Fbacktrack~E information.
  1285. .
  1286. .FRAME Expansion references
  1287. .TITLE Changing what you see in a frame
  1288.  
  1289. When users of differing expertise read a hyperfile, they do
  1290. not necessarily want to read the full detail about a topic.
  1291.  
  1292. It is possible to have varying degrees of detail 'hidden'
  1293. from display until a request is made for that detail. In
  1294. hypertext jargon, this is known as an expansion reference.
  1295. To show how this works, select the following reference.
  1296.  
  1297. [d]  ~ADetail~PZL1~Kd~E 
  1298.  
  1299. ~h1~DNWhen you first read this frame, this paragraph was not shown.
  1300. ~h1Selecting the 'Detail' reference caused this text to be displayed.
  1301. ~h1If you now select the 'Detail' reference again, it will disappear.~DT
  1302. ~h1
  1303. When you return to the frame, the level of detail displayed will
  1304. remain as you left it. It is also possible to influence the degree
  1305. of detail shown throughout a hyperfile in a similar fashion.
  1306. .
  1307. .FRAME Note
  1308. .TITLE display a note
  1309.  
  1310. A note is a pop-up display of information. This appears in a
  1311. box which is smaller than the overall size of the screen.
  1312.  
  1313. The note may have highlighted ~Freferences~E or input fields in it,
  1314. and this can be selected as for those in the main ~Fframe~E text.
  1315.  
  1316. The note is cleared when a reference is selected from it, or
  1317. when a ~Fmouse~E button or ~Fkey~PFkeyboard~E is pressed.
  1318.  
  1319. When the note is finished with, it 'pops down', redisplaying
  1320. the part of the screen it had overlayed.
  1321. .
  1322. .FRAME Menu
  1323. .TITLE popup a menu
  1324. A pop-up menu is a list of options displayed so that a choice
  1325. can be made from them. Menu options can result in any kind of
  1326. ~Faction~PFactions~E, unless the menu is used to provide the parameter for
  1327. an action, in which case all options have the same effect.
  1328.  
  1329. An option is chosen by clicking the ~Fleft~E mouse button, or pressing
  1330. the ENTER key, when the required option is highlighted. Function
  1331. keys may be mapped to the menu options, in which case the keys are
  1332. shown as 'F1', 'F2' etc. alongside the options. An option may be
  1333. selected by pressing the corresponding key. If function keys are
  1334. not mapped, the initial letter of the option may be pressed to
  1335. select the option.
  1336.  
  1337. The menu can be cancelled by pressing the ~Fright~E mouse button, or
  1338. pressing the ESCAPE key.
  1339.  
  1340. Certain menus contain ~FMenu symbols~E which show the kind of actions
  1341. which will be performed when the options are selected.
  1342. .
  1343. .FRAME Menu symbols
  1344. .TITLE Guide to menu actions
  1345. Some menus contain symbols to act as a guide to what the menu
  1346. actions are. These symbols are as follows:-
  1347.  
  1348. ƒ       Frame                          Note
  1349.    ≡    Menu                       ≈    Script
  1350. «       Backtrack               Ω       Quit
  1351.    δ    DOS command                Σ    Direct command
  1352. ∞       Chained command         Φ       Change directory
  1353.    #    Set key mapping            α    Set/test variable
  1354. º       Set option              °       Refresh screen
  1355.    τ    Type file                  π    Print/popup message
  1356. ≤       Open/Read file          ≥       Open/write file
  1357.    ?    Do unspecified action      ▒    Graphic display
  1358. ¿       Extended/negative actn  ¬       Next input field
  1359.    ⌡    Jump in script             ⌠    Label/load variable
  1360. .
  1361. .FRAME Script
  1362. .TITLE perform a script
  1363.  
  1364. A script is a sequence of ~Factions~E, possibly with some flow
  1365. control structures such as loops and selections.
  1366.  
  1367. Scripts are used for a number of purposes:-
  1368.  
  1369.  - to display a sequence of ~Fnote~Es
  1370.  
  1371.  - to set up a number of parameters for a program command line
  1372.  
  1373.  - to set variables to modify the displayed information
  1374.  
  1375.  - to act as a small 'program' to perform complex processing
  1376. .
  1377. .FRAME Action reference
  1378. .TITLE do some action
  1379.  
  1380. An action reference shows that some action is to take
  1381. place that is not one of the usual actions i.e. a ~FMenu~E,
  1382. a ~FNote~E, a ~FFrame~E or a ~FScript~E.
  1383.  
  1384. Selecting an action reference will have some effect other than
  1385. the usual actions, and the contextual information should give
  1386. you some clue as to what this may be.
  1387. .
  1388. .FRAME Backtrack
  1389. .TITLE retracing your steps
  1390.  
  1391. When you have followed up a ~Freference~PFreferences~E, you may wish to
  1392. retrace your steps back to the initial text you were reading.
  1393.  
  1394. The backtrack capability allows you to do this.
  1395.  
  1396. The ~Fcontrol menu~E has an option called BACKTRACK, which steps
  1397. you back one frame.
  1398.  
  1399. If you wish to go directly back without having to do it one
  1400. step at a time, the SELECT BACK option of the ~Fcontrol menu~E
  1401. will allow you to choose any frame on the ~Fbacktrack list~E.
  1402. .
  1403. .FRAME Backtrack list
  1404. .TITLE multiple backtrack
  1405.  
  1406. The ~Fcontrol menu~E provides an option to select the point in
  1407. the list of text frames you have visited to which you wish
  1408. to return, 'unwinding' the list of frames you have visited
  1409. since then in the process.
  1410.  
  1411. A full screen menu is presented, allowing you to select a
  1412. frame reference from the frames visited.
  1413. .
  1414. .FRAME Control menu
  1415. .TITLE general control menu for HyperShell
  1416.  
  1417. When you are viewing a text frame, you may request a
  1418. general menu for controlling HyperShell, by pressing
  1419. either the ~Fright~E mouse button or the ESCAPE key on
  1420. the ~Fkeyboard~E.
  1421.  
  1422. This menu presents a number of options.
  1423. .
  1424. .FRAME Control options
  1425. .TITLE choices on the control menu
  1426.  
  1427. The default control menu offers the following options:-
  1428.  
  1429. ~nHOME~E (or ~nHELP~E)  -   Go to home frame (or give help)
  1430. ~nCONTENTS~E        -   List contents of current file for selection
  1431. ~nBACKTRACK~E       -   Backtrack one frame
  1432. ~nSELECT BACK~E     -   List backtrack list for selection
  1433. ~nNOTEPAD~E         -   List noted actions for selection
  1434. ~nSEARCH~E          -   Search current file for text string
  1435. ~nTYPE FILE~E       -   Type contents of text file
  1436. ~nDO ACTION~E       -   Allow action to be directly requested
  1437. ~nDOS SHELL~E       -   Provide DOS command subshell
  1438. ~nEXIT TO DOS~E     -   Exit directly to DOS
  1439. .
  1440. .NOTE HOME
  1441.  The HOME frame is the first ~Fframe~E in a ~Fhyperfile~E, and
  1442.  generally provides some kind of lead-in to the browsing
  1443.  of the hyperfile. It is useful to return to the home
  1444.  frame if you appear to be lost. The ~Fcontents~E list and
  1445.  the ~Fbacktrack~E list are also useful when this happens.
  1446. .
  1447. .NOTE HELP
  1448.  The HELP menu is usually invoked by pressing the '?' key,
  1449.  although some hyperfiles may map the first control menu
  1450.  action (and the F1 key) to it.
  1451.  
  1452.  The help menu is an application specific set of information
  1453.  and will usually offer a number of note displays describing
  1454.  the application provided by the hyperfile. 
  1455. .
  1456. .NOTE CONTENTS
  1457.  This command lists the contents of the current ~Fhyperfile~E.
  1458.  The list is displayed a page at a time, and a selection
  1459.  can be made from the highlighted ~Fframe~E names, using the
  1460.  usual ~Freference~PFreferences~E selection mechanism.
  1461. .
  1462. .NOTE NOTEPAD
  1463.  This option lists the ~Freferences~E added to the notepad
  1464.  list, and permits them to be selected and followed.
  1465.  
  1466.  During this paged display, the entries on display can
  1467.  be removed from the notepad by pressing the Del key on
  1468.  the keypad when the mouse cursor is positioned over the
  1469.  item. All occurrences of the reference in the notepad
  1470.  will be removed.
  1471. .
  1472. .NOTE SEARCH
  1473.  This option prompts for a search string and then
  1474.  searches the title and text of all frames in the
  1475.  current hyperfile for occurrences of the string.
  1476.  
  1477.  All occurrences are listed, followed by the frame name
  1478.  of the frame containing the search string.
  1479.  
  1480.  The search is not case sensitive, and the search
  1481.  string may be entered in lower or uppercase.
  1482. .
  1483. .NOTE TYPE FILE
  1484.  This asks for a file name and lists the file a page at a time.
  1485.  Pressing the ~Fleft~E ~Fmouse~E button or the RETURN key returns to
  1486.  the frame display, TYPE FILE will return to the file at the
  1487.  current point.
  1488.  
  1489.  The PgUp and PgDn keys may be used to move through the file, and
  1490.  the HOME key and the END move to the start and end of the file.
  1491.  The '/' or F6 key allows a search string to be entered, and a search
  1492.  made. The F5 key searches for the next occurence of the search string.
  1493.  The '#' key allows a page number to be entered to position the file.
  1494.  
  1495.  The ~Fright~E ~Fmouse~E button or ESCAPE terminates the display.
  1496. .
  1497. .NOTE DO ACTION
  1498.  This option permits an ~Faction~PFactions~E command to be entered
  1499.  directly. An example action would be to perform a DOS
  1500.  command such as DIR /W by entering the ~Faction~PFactions~E :-
  1501.  
  1502.     DDIR /W
  1503. .
  1504. .NOTE DOS SHELL
  1505.  This option permits a DOS shell to be executed to allow
  1506.  commands to be entered at the command line.
  1507.  
  1508.  When you wish to return to ~FHyperShell~E, enter the EXIT
  1509.  command to the DOS command processor.
  1510. .
  1511. .NOTE EXIT TO DOS
  1512.  This action exits immediately from ~FHyperShell~E.
  1513.  No confirmation is sought before doing this, unless
  1514.  configured into the hyperfile.
  1515. .
  1516. .FRAME Notepad
  1517. .TITLE List noted actions for selection
  1518.  
  1519. This option lists the ~Freferences~E added to the notepad
  1520. list, and permits them to be selected and followed.
  1521.  
  1522. During this paged display, the entries on display can
  1523. be removed from the notepad by pressing the Del key on
  1524. the keypad when the mouse cursor is positioned over the
  1525. item. All occurrences of the reference in the notepad
  1526. will be removed.
  1527. .
  1528. .FRAME Contents
  1529. .TITLE list contents of HyperFile
  1530.  
  1531. This command lists the contents of the current ~Fhyperfile~E.
  1532. The list is displayed a page at a time, and a selection
  1533. can be made from the highlighted ~Fframe~E names, using the
  1534. usual ~Freference~PFreferences~E selection mechanism.
  1535. .
  1536. .FRAME Type file
  1537. .TITLE list contents of text file
  1538.  
  1539. The contents of the specified file are listed. The listing is
  1540. presented a page at a time, and certain keys may be used for
  1541. movement up and down the file. Other keys are used for
  1542. control purposes. Pressing the ~Fleft~E ~Fmouse~E button or the
  1543. RETURN key returns to the frame display, where subsequent selection
  1544. of the TYPE FILE option returns to the file at the current point.
  1545.  
  1546. The PgUp and PgDn keys may be used to move through the file, and
  1547. the HOME key and the END move to the start and end of the file.
  1548.  
  1549. The '/' or F6 key allows a search string to be entered, and a search
  1550. made. The F5 key searches for the next occurence of the search string.
  1551.  
  1552. The '#' key allows a page number to be entered to position the file.
  1553.  
  1554. The ~Fright~E ~Fmouse~E button or ESCAPE terminates the display.
  1555. .
  1556. .FRAME Actions
  1557. .TITLE Commands for control of HyperShell
  1558.  
  1559. HyperShell actions are the commands used to cause various
  1560. this to take place. There are a large number of actions,
  1561. many of which can be further modified to influence the
  1562. resulting action. For example, actions perform the
  1563. following kinds of things:-
  1564.  
  1565. Display frames, notes, menus and text files.
  1566.  
  1567. Display Graphic screens to allow selection.
  1568.  
  1569. Run programs or batch files.
  1570.  
  1571. Run scripts, and control the flow of scripts.
  1572.  
  1573. Set configuration options, colours and key mappings.  
  1574. .
  1575. .FRAME Effects
  1576. .TITLE Special presentation effects
  1577.  
  1578. HyperShell provides some facilities for special display
  1579. effects and control over the creation of subwindows for
  1580. special purposes. The box draw facility is used for the
  1581. double line frame in this hyperfile. It can also be used
  1582. for drawing adhoc boxes on the screen. A similar facility
  1583. allows a window, with an optional box surround, to be
  1584. defined for subsequent text output. Also it is possible
  1585. to enter delays in text, and to use a 'teletype mode'
  1586. which slowly displays the text. These facilities are
  1587. demonstrated by the following reference:-
  1588.  
  1589. [e]   ~ABox explode and windows~PsExplode~Ke~E
  1590. .
  1591. .SCRIPT Explode
  1592. Vx=1
  1593. Vy=1
  1594. O*00;O*31
  1595. -- clear screen
  1596. i~X1~Y1~a~X79~Y24~b6
  1597. LEXP
  1598. Vj=80-x
  1599. Vk=25-y
  1600. i~X$x~Y$y~a~X$j~Y$k~DK~b1~DT
  1601. Vx=x+1
  1602. Vy=y+1
  1603. vy12;jeXOUT
  1604. JEXP
  1605. LXOUT
  1606. i~X$x~Y$y This is an example of what we can do with box drawings
  1607. i~X$x~d What else can we do with boxes - wait and see
  1608. Y&G200
  1609. LEXP2
  1610. Vj=80-x
  1611. Vk=25-y
  1612. i~DT~X$x~Y$y~a~X$j~Y$k~b7
  1613. Vx=x-1
  1614. Vy=y-1
  1615. vy0;jeDOWIN
  1616. JEXP2
  1617. LDOWIN
  1618. i~X1~Y1~a~X79~Y24~DD~b6
  1619. -- i~X1~Y1~a~X78~Y24~b6
  1620. Vx=1;Vy=1
  1621. LWINS
  1622. Vs&N$xKJMUVSWALP
  1623. Vj=x+10
  1624. Vk=y+4
  1625. -- i~X$x~Y$y~a~X$j~Y$k~D$s~b3~DT
  1626. i~X$x~Y$y~a~X$j~Y$k~D$s~b3
  1627. iHi there
  1628. iThis is
  1629. ia window
  1630. Zr
  1631. Vx=x+8
  1632. Vy=y+2
  1633. vy18;jgNEXT
  1634. JWINS
  1635. LNEXT
  1636. Y&G400
  1637. O*30;O*01
  1638. y
  1639. .
  1640.